home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_emacs.idb / usr / freeware / catman / u_man / cat1 / gnuserv.Z / gnuserv
Encoding:
Text File  |  1998-10-28  |  8.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      GGGGNNNNUUUUSSSSEEEERRRRVVVV((((1111))))             GGGGNNNNUUUU EEEEmmmmaaaaccccssss SSSSeeeerrrrvvvveeeerrrr            GGGGNNNNUUUUSSSSEEEERRRRVVVV((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       gnuserv, gnuclient, gnudoit -    Server and Clients for GNU
  10.       Emacs
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       ggggnnnnuuuucccclllliiiieeeennnntttt [-q] [[-h hostname]    [-p port] [-r pathname]]
  14.       [[+line] path] ...
  15.       ggggnnnnuuuuddddooooiiiitttt [-q] [[-h hostname] [-p port]] [sexpr] ...
  16.       ggggnnnnuuuusssseeeerrrrvvvv
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.       _g_n_u_c_l_i_e_n_t allows the user to request a running GNU Emacs
  20.       process to edit the named files or directories.
  21.  
  22.       _g_n_u_d_o_i_t allows the user to request a running GNU Emacs
  23.       process to evaluate the given    arguments inside a progn LISP
  24.       form.
  25.  
  26.       _g_n_u_s_e_r_v is the server    program    that is    set running by GNU
  27.       Emacs    to handle all incoming and outgoing requests. It is
  28.       not usually invoked directly,    but is started from GNU    Emacs
  29.       by the LISP form (server-start).
  30.  
  31.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  32.       ----qqqq      This option informs both _g_n_u_c_l_i_e_n_t and _g_n_u_d_o_i_t to
  33.           exit once connection has been    made with the GNU
  34.           Emacs    process. Normally _g_n_u_c_l_i_e_n_t waits until    all of
  35.           the files on the command line    have been finished
  36.           with (their buffers killed) by the GNU Emacs
  37.           process, and _g_n_u_d_o_i_t normally    waits around for
  38.           evaluation of    its arguments by the GNU Emacs
  39.           process, and prints the results or error conditions.
  40.  
  41.       ----hhhh _h_o_s_t_n_a_m_e
  42.           Used only with Internet-domain sockets, this option
  43.           specifies the    host machine which should be running
  44.           _g_n_u_s_e_r_v.  If this option is not specified then the
  45.           value    of the environment variable GNU_HOST is    used
  46.           if set, otherwise the    hostname of the    machine
  47.           running the program is used.
  48.           Note that an internet    address    may be specified
  49.           instead of a hostname    which can speed    up connections
  50.           to the server    by quite a bit,    especially if the
  51.           client machine is running YP.
  52.           Note also that a hostname of uuuunnnniiiixxxx can    be used    to
  53.           specify that the connection to the server should use
  54.           a Unix-domain    socket (if supported) rather than an
  55.           Internet-domain socket.
  56.  
  57.       ----pppp _p_o_r_t Used only with Internet-domain sockets, this option
  58.           specifies the    service    port used to communicate
  59.           between server and clients. If this option is    not
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 7/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      GGGGNNNNUUUUSSSSEEEERRRRVVVV((((1111))))             GGGGNNNNUUUU EEEEmmmmaaaaccccssss SSSSeeeerrrrvvvveeeerrrr            GGGGNNNNUUUUSSSSEEEERRRRVVVV((((1111))))
  71.  
  72.  
  73.  
  74.           specified, then the value of the environment
  75.           variable GNU_PORT is used, if    set, otherwise a
  76.           service called ``gnuserv'' is    looked up in the
  77.           services database. Finally, if no other value    can be
  78.           found    for the    port, then a default port is used
  79.           which    is usually 21490 + uid.
  80.           Note that since _g_n_u_s_e_r_v doesn't allow    command-line
  81.           options, the port for    it will    have to    be specified
  82.           via one of the alternative methods.
  83.  
  84.       ----rrrr _p_a_t_h_n_a_m_e
  85.           Used only with Internet-domain sockets, the pathname
  86.           argument may be needed to inform GNU Emacs how to
  87.           reach    the root directory of a    remote machine.
  88.           _g_n_u_c_l_i_e_n_t prepends this string to each path argument
  89.           given. For example, if you were trying to edit a
  90.           file on a client machine called otter, whose root
  91.           directory was    accessible from    the server machine via
  92.           the path /net/otter, then this argument should be
  93.           set to '/net/otter'. If this option is omitted, then
  94.           the value is taken from the environment variable
  95.           GNU_NODE, if set, or the empty string    otherwise.
  96.           Note that on hp9000/s300 and hp9000/s800, the
  97.           pathname, if not specified by    the user, is guessed.
  98.  
  99.       ppppaaaatttthhhh      This is the path of the file to be edited. If    the
  100.           file is a directory, then the    directory browsers
  101.           dired    or monkey are usually invoked instead.
  102.  
  103.       sssseeeexxxxpppprrrr      This is part of a GNU    Emacs LISP expression to
  104.           evaluate. All    the sexprs are concatenated together
  105.           and wrapped in a progn form before sending to    GNU
  106.           Emacs.
  107.  
  108.      SSSSEEEETTTTUUUUPPPP
  109.       In order to use the programs,    the file gnuserv.el can    be
  110.       copied into a    directory on your GNU Emacs load-path, and
  111.       loaded into GNU Emacs    by the GNU Emacs LISP form (load
  112.       "gnuserv"). The server can then be started by    the GNU    Emacs
  113.       LISP form (server-start).
  114.  
  115.      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  116.       gnudoit -q '(mh-smail)'
  117.  
  118.       gnuclient -h otter -r    /net/otter /tmp/*
  119.  
  120.      SSSSYYYYSSSSVVVV IIIIPPPPCCCC
  121.       SysV IPC is used to communicate between _g_n_u_c_l_i_e_n_t, _g_n_u_d_o_i_t
  122.       and _g_n_u_s_e_r_v if the symbol SYSV_IPC is    defined    at the top of
  123.       gnuserv.h. This is incompatible with both Unix-domain    and
  124.       Internet-domain socket communication as described below. A
  125.       file called /tmp/gsrv??? is created as a key for the message
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 7/23/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      GGGGNNNNUUUUSSSSEEEERRRRVVVV((((1111))))             GGGGNNNNUUUU EEEEmmmmaaaaccccssss SSSSeeeerrrrvvvveeeerrrr            GGGGNNNNUUUUSSSSEEEERRRRVVVV((((1111))))
  137.  
  138.  
  139.  
  140.       queue, and if    removed    will cause the communication between
  141.       server and client to fail until the server is    restarted.
  142.  
  143.      UUUUNNNNIIIIXXXX----DDDDOOOOMMMMAAAAIIIINNNN SSSSOOOOCCCCKKKKEEEETTTTSSSS
  144.       A Unix-domain    socket is used to communicate between
  145.       _g_n_u_c_l_i_e_n_t, _g_n_u_d_o_i_t and _g_n_u_s_e_r_v if the    symbol
  146.       UNIX_DOMAIN_SOCKETS is defined at the    top of gnuserv.h.  A
  147.       file called /tmp/gsrv??? is created for communication    and if
  148.       deleted will cause communication between server and client
  149.       to fail.
  150.  
  151.      IIIINNNNTTTTEEEERRRRNNNNEEEETTTT----DDDDOOOOMMMMAAAAIIIINNNN SSSSOOOOCCCCKKKKEEEETTTTSSSS
  152.       Internet-domain sockets are used to communicate between
  153.       _g_n_u_c_l_i_e_n_t, _g_n_u_d_o_i_t and _g_n_u_s_e_r_v if the    symbol
  154.       INTERNET_DOMAIN_SOCKETS is defined at    the top    of gnuserv.h.
  155.       Both Internet-domain and Unix-domain sockets can be used at
  156.       the same time.
  157.  
  158.      SSSSEEEECCCCUUUURRRRIIIITTTTYYYY
  159.       Using    Internet-domain    sockets, a more    robust form of
  160.       security is needed that wasn't necessary with    either Unix-
  161.       domain sockets or SysV IPC.
  162.       _g_n_u_s_e_r_v performs a limited form of security at the machine
  163.       level. By default only connections from the host where the
  164.       server is running will be allowed. All other server
  165.       connections will be rejected with a cryptic message (which
  166.       is displayed only by _g_n_u_d_o_i_t). Alternatively,    if the
  167.       variable GNU_SECURE can be found in _g_n_u_s_e_r_v's    environment,
  168.       and it names a readable filename, then this file is opened
  169.       and assumed to be a list of hosts, one per line, from    which
  170.       the server will allow    requests. Note that a host may be
  171.       either a internet address, or    a hostname. If this file
  172.       contains a lot of hostnames then the server may take quite a
  173.       time to start    up.
  174.  
  175.      KKKKNNNNOOOOWWWWNNNN BBBBUUUUGGGGSSSS
  176.       If GNU Emacs attempts    to send    a string containing a newline
  177.       character to _g_n_u_s_e_r_v,    then _g_n_u_s_e_r_v will die.
  178.  
  179.      FFFFIIIILLLLEEEESSSS
  180.       ////ttttmmmmpppp////ggggssssrrrrvvvv????????????
  181.  
  182.       ~~~~////....eeeemmmmaaaaccccssss
  183.           GNU Emacs customization file,    see emacs(1).
  184.  
  185.      AAAAUUUUTTTTHHHHOOOORRRR....
  186.       Andy Norman (ange@hplb.hpl.hp.com), based heavily upon
  187.       etc/emacsclient.c, etc/server.c and lisp/server.el from the
  188.       GNU Emacs 18.52 distribution.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 7/23/98)
  196.  
  197.  
  198.  
  199.